How-to implement the HTML renderer in your application

Requirements

• Your code must use Juce in the same version as UZI (usually UZI is using the lastest Juce version), unless you trick it with dynamic libraries
• Your code must use and reside in juce namespace (UZI heavily relies on namespaces to avoid name clashing)
• Your code must use JUCE_T macro for unicode string, and not the simpler, but poisonous T macro
• (Recommended)Your project is correctly split in multiple folders (else you'll have hundred of files in your project folder)

Step-by-step tutorial

1. Get a copy of UZI's subversion repository from here.
   If you don't know about subversion, then please help yourself by learning the basics about shared source.
2. You'll find all required code in include and src subfolder of the repository
3. Copy all the sources from above mentioned folders in your project, keeping the hierarchical directory structure (you can export it with SVN, if you don't intend to modify those sources)
4. In the component MyComponent where you want to render an HTML content, add a member of type:

      juce::BrowserContent browserContent;

5. Add an include to include/GUI/components/BrowserContent.hpp in the MyComponent.hpp header file
6. In MyComponent::MyComponent constructor, construct the BrowserContent like this:

      browserContent = new BrowserContent(JUCE_T("../path/to/file.htm");
      addAndMakeVisible(browserContent);
   

7. In MyComponent::resized() callback, add:

      int width = getWidth(); int height = getHeight();
      // Simple child component resizing
      browserContent->setSize(width, height);
      // Just make sure the renderer can fit the renderer data, if not, grow us a little bit 
      // You might simply not need this, so remove the 2 lines below
      if (height = browserContent->requiredHeightAfterRendering() > getHeight())
      	setSize(width, height);
   

8. Compile, link and run, and enjoy the HTML rendering where MyComponent is displayed

Remarks

(C) An X-Ryl669 project 2007

This document describes Unlimited Zooming Interface source code. UZI stands for Unlimited Zooming Interface, and source code license is